

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">

<html>
<head>
<script type="text/javascript" src="helpman_topicinit.js"></script>

<title>Version Control with SCC [Enterprise Architect User Guide]</title>

<meta name="keywords" content="Enterprise Architect, Sparx Systems, UML, Version Control,Version Control SCC Options,Version Control SCC, Providers DialogSCC, Providers Dialog,SCC,SCC Version Control Options,SCC Providers Dialog">
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
<meta http-equiv="Content-Style-Type" content="text/css" />

<link type="text/css" href="default.css" rel="stylesheet" />
<style type="text/css">
  A, A:Visited
  {
    color: #00F;
  }

  A:Active, A:Hover
  {
    color: #F00;
  }

  OL
  {
    margin: 5px 0 5px 48px;
  }

  UL
  {
    margin-bottom: 3px;
    margin-top: 0;
  }

  #nsr
  {
    background-color: #D4DFFF;
  }

  #nsr A
  {
    text-decoration: none;
  }

  #mainbody
  {
    padding: 8px;
  }

  .p_BodyText
  {
    padding: 5px 0;
  }
</style>



<style type="text/css" media="screen">
  BODY
  {
    background-color: #FFFFFF;
  }

  #nsr
  {
    padding: 6px 6px 0 6px;
    border-bottom: none;
    vertical-align: top;
    z-index: 2;
    visibility: visible;
    left: 0;
    top: 0;
    position: absolute;
  }

  #mainbody
  {
    left: 0;
    top: 0;
    margin: 0;
    position: absolute;
    padding: 10px;
    overflow: auto;
    height: 100%;
    z-index: 1;
    background-repeat: no-repeat;
    background-position: bottom right;
    background-attachment: fixed;
  }
</style>

<style type="text/css" media="print">
  #nsr
  {
    visibility: none;
  }

  #mainbody
  {
    overflow: visible;
  }
</style>
<script type="text/javascript" language="JavaScript" src="nonscroll.js"></script>

</head>
<body scroll="no">

<div id="page">



        <div id="content">
          <div id="content-inner">
          



  
          <div id="nsr">
            <table border="0" cellspacing="0" cellpadding="4" width="100%">
              <tr valign="top">
                <td align="left">
  


                  <p class="p_Heading1"><span class="f_Heading1">Version Control with SCC</span></p>



  
                </td>
                <td align="right">
                  <a href="introduction.htm" onmouseover="document.images.main.src='button_main_h.gif'" onmouseout="document.images.main.src='button_main.gif'">
                    <img name="main" src="button_main.gif" border=0 alt="Return to Introduction">
                  </a>&nbsp;
    
                  <a href="usingnestedversioncontrolp.htm" onmouseover="document.images.prev.src='button_prev_h.gif'" onmouseout="document.images.prev.src='button_prev.gif'">
                    <img name=prev src="button_prev.gif" border=0 alt="Previous page" />
                  </a>&nbsp;
    
    
    
                  <a href="sccversioncontrolupgradefo.htm" onmouseover="document.images.next.src='button_next_h.gif'" onmouseout="document.images.next.src='button_next.gif'">
                    <img name=next src="button_next.gif" border=0 alt="Next page" />
                  </a>
    
    
                </td>
              </tr>
            </table>
          </div>
          <div id="mainbody">
  


                <p class="p_BodyText"><span class="f_BodyText">To set up an SCC version control configuration, you must:</span></p>
<ul style="text-indent: 0px; margin-left: 30px; list-style-position: outside;">
<li><span class="f_Bulletlist1">Set up the source code control provider with SCC, and</span></li>
<li><span class="f_Bulletlist1">Connect the Enterprise Architect model to version control with SCC.</span></li>
</ul>
<p class="p_BodyText"><span class="f_BodyText">See also, the topic on version control with SCC when </span><span class="f_BodyText" style="font-style: italic;"><a href="sccversioncontrolupgradefo.htm">Upgrading at Enterprise Architect 4.5</a></span><span class="f_BodyText">.</span></p>
<p class="p_SubHeadingL1"><span class="f_SubHeadingL1">Set Up the Source Code Control Provider with SCC</span></p>
<p class="p_BodyText"><span class="f_BodyText">To set up the third-party source code control provider, see the documentation provided with that application. A repository must be set up using the SCC provider and access to that repository must be available to all intended users.</span></p>
<p class="p_SubHeadingL1"><span class="f_SubHeadingL1">Connect an Enterprise Architect Model to Version Control with SCC</span></p>
<p class="p_BodyText"><span class="f_BodyText">To connect an Enterprise Architect model to version control, follow the steps below:</span></p>
<ol style="text-indent: 0px; margin-left: 48px; list-style-position: outside;">
<li value=1><span class="f_NumberedList">Open or create the Enterprise Architect model to place under version control.</span></li>
<li value=2><span class="f_NumberedList">Select the </span><span class="f_MenuKeyField">Project | Version Control | Version Control Settings</span><span class="f_NumberedList"> menu option. The </span><span class="f_UIControl">Version Control Settings</span><span class="f_NumberedList"> dialog displays.</span><br>
<span class="f_NumberedList">&nbsp;</span><br>
<img src="versioncontroldlg.png" width="526" height="662" border="0" alt="VersionControlDlg"><span class="f_NumberedList">.</span><br>
<span class="f_NumberedList">&nbsp;</span></li>
<li value=3><span class="f_NumberedList">Click on the </span><span class="f_MenuKeyField">New</span><span class="f_NumberedList"> button.</span></li>
<li value=4><span class="f_NumberedList">In the </span><span class="f_MenuKeyField">Unique ID</span><span class="f_NumberedList"> field</span><span class="f_NumberedList">, type </span><span class="f_NumberedList">a suitable name. Click on the </span><span class="f_MenuKeyField">SCC</span><span class="f_NumberedList"> radio button.</span></li>
<li value=5><span class="f_NumberedList">To the right of the </span><span class="f_MenuKeyField">Local Project</span><span class="f_NumberedList"> path field, click on the </span><span class="f_MenuKeyField">Select Path...</span><span class="f_NumberedList"> button. The </span><span class="f_UIControl">Browse for Folder</span><span class="f_NumberedList"> dialog displays.</span><br>
<span class="f_NumberedList">&nbsp;</span><br>
<img src="sccpath.png" width="306" height="324" border="0" alt="SCCpath"><br>
<span class="f_NumberedList">&nbsp;</span></li>
<li value=6><span class="f_NumberedList">Locate and click on the local folder in which to keep local working copies of the XML files to be stored in the Version Control repository.</span></li>
<li value=7><span class="f_NumberedList">Click on the </span><span class="f_MenuKeyField">OK</span><span class="f_NumberedList"> button. The </span><span class="f_UIControl">Select SCC Provider</span><span class="f_NumberedList"> dialog displays.</span><br>
<span class="f_NumberedList">&nbsp;</span><br>
<img src="dlgproviders1.png" width="399" height="302" border="0" alt="DlgProviders1"><br>
<span class="f_NumberedList">&nbsp;</span></li>
</ol>
<div style="text-align: left; text-indent: -21px; padding: 0px 0px 0px 0px; margin: 5px 0px 0px 48px;"><table cellspacing="0" cellpadding="2" border="0" style="border: none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:bottom;">
<td valign="bottom" width="952" bgcolor="#efeff7" style="width:952px; background-color:#efeff7;"><p class="p_TiporNote" style="border-top: none; border-right: none; border-left: none;"><span class="f_TiporNote">Note:</span></p>
</td>
</tr>
<tr style="text-align:left;">
<td width="952" bgcolor="#f7f7ff" style="width:952px; background-color:#f7f7ff;"><p class="p_TiporNoteText"><span class="f_TiporNoteText">All users of the shared database must specify the same SCC provider.</span></p>
</td>
</tr>
</table>
</div>
<ol style="text-indent: 0px; margin-left: 48px; list-style-position: outside;">
<li value=8><span class="f_NumberedList">Click on an SCC provider, and click on the </span><span class="f_MenuKeyField">OK</span><span class="f_NumberedList"> button to return to the </span><span class="f_UIControl">Version Control Settings</span><span class="f_NumberedList"> dialog.</span></li>
<li value=9><span class="f_NumberedList">Click on the </span><span class="f_MenuKeyField">Save</span><span class="f_NumberedList"> button to save the configuration you have defined.</span><br>
<span class="f_NumberedList">&nbsp;</span><br>
<span class="f_NumberedList">The SCC provider is likely to prompt you for various details including the name of the project to connect to, and perhaps the user name to use when you log in.</span></li>
<li value=10><span class="f_NumberedList">The new configuration is added to the list in the </span><span class="f_UIControl">Defined Configurations</span><span class="f_NumberedList"> panel.</span></li>
</ol>
<div style="text-align: left; text-indent: -21px; padding: 0px 0px 0px 0px; margin: 5px 0px 0px 48px;"><table cellspacing="0" cellpadding="2" border="0" style="border: none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:bottom;">
<td valign="bottom" width="955" bgcolor="#efeff7" style="width:955px; background-color:#efeff7;"><p class="p_TiporNote" style="border-top: none; border-right: none; border-left: none;"><span class="f_TiporNote">Note:</span></p>
</td>
</tr>
<tr style="text-align:left;">
<td width="955" bgcolor="#f7f7ff" style="width:955px; background-color:#f7f7ff;"><p class="p_TiporNoteText"><span class="f_TiporNoteText">A new entry is also created in the <a href="localpathdlg.htm">Local Paths</a> list, with the same ID as the new version control configuration. The </span><span class="f_MenuKeyField">Local Path</span><span class="f_TiporNoteText"> entry records the Local Project path, for use in subsequent path substitutions.</span></p>
</td>
</tr>
</table>
</div>
<ol style="text-indent: 0px; margin-left: 48px; list-style-position: outside;">
<li value=11><span class="f_NumberedList">When you have finished defining your version control configurations, click on the </span><span class="f_MenuKeyField">Close</span><span class="f_NumberedList"> button.</span></li>
</ol>
<p class="p_BodyText"><span class="f_BodyText">For further information on the fields on the </span><span class="f_UIControl">Version Control Settings</span><span class="f_BodyText"> dialog, see the following table.</span></p>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 5px 0px 5px 13px;"><table cellspacing="0" cellpadding="0" border="0" style="border: none; border-spacing:0px; border-collapse: collapse;">
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="143" bgcolor="#e3e6ed" style="width:143px; background-color:#e3e6ed; border: solid 1px #000000;"><p class="p_Tableheader"><span class="f_Tableheader">Field</span></p>
</td>
<td valign="top" width="585" bgcolor="#e3e6ed" style="width:585px; background-color:#e3e6ed; border: solid 1px #000000;"><p class="p_Tableheader"><span class="f_Tableheader">Use to</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="143" style="width:143px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">This model is private</span></p>
</td>
<td valign="top" width="585" style="width:585px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Specify whether all users connect to a single shared copy of the model (e.g. a DBMS) or each user connects to their own private copy of the model.</span></p>
<p class="p_Tabletext"><span class="f_Tabletext">When unselected (for shared models), the option disables the </span><span class="f_Tabletext" style="font-weight: bold;">File History - Retrieve</span><span class="f_Tabletext"> functionality when the selected package is checked out by another user. This prevents modifications that might have been made by the other user from being discarded through importing a prior revision from version control.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="143" style="width:143px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">Save nested version controlled packages to stubs only</span></p>
</td>
<td valign="top" width="585" style="width:585px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Set nested version controlled packages to stubs or fully expanded trees. Defaults to selected.</span></p>
<p class="p_Tabletext"><span class="f_Tabletext">For a full explanation of this option, see <a href="usingnestedversioncontrolp.htm">Version Control Nested Packages</a>.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="143" style="width:143px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">Unique ID</span></p>
</td>
<td valign="top" width="585" style="width:585px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Specify a configuration name that readily distinguishes this configuration from other configurations. The unique ID is displayed as a selection in the list of Version Control configurations a package can connect to.</span></p>
<p class="p_Tabletext"><span class="f_Tabletext">You can also click on the drop-down arrow and select a previous version control configuration, providing the configuration is not in the current model.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="143" style="width:143px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">Local Project Path</span></p>
</td>
<td valign="top" width="585" style="width:585px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Specify the folder in which the XML files representing the packages are stored. This folder should already exist before it is specified here.</span></p>
<p class="p_Tabletext"><span class="f_Tabletext">Every PC using version control should have its own local SCC project folder, and this should not be a shared network folder. Particularly bear this in mind if you are creating a .EAP file that is to be shared (e.g. a SQL database).</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="143" style="width:143px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">Current User</span></p>
</td>
<td valign="top" width="585" style="width:585px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Read only. Shows your user name as the user currently logged into the SCC provider.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="143" style="width:143px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">SCC Provider</span></p>
</td>
<td valign="top" width="585" style="width:585px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Read only. Shows the name of the provider specified in the database.</span></p>
</td>
</tr>
<tr style="text-align:left;vertical-align:top;">
<td valign="top" width="143" style="width:143px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext" style="font-weight: bold;">SCC Project</span></p>
</td>
<td valign="top" width="585" style="width:585px; border: solid 1px #000000;"><p class="p_Tabletext"><span class="f_Tabletext">Read only. Shows the project selected during the initial setup of the connection to the SCC provider.</span></p>
</td>
</tr>
</table>
</div>
<div style="text-align: left; text-indent: 0px; padding: 0px 0px 0px 0px; margin: 5px 0px 5px 13px;"><table cellspacing="0" cellpadding="2" border="0" style="border: none; border-spacing:0px;">
<tr style="text-align:left;vertical-align:bottom;">
<td valign="bottom" width="955" bgcolor="#efeff7" style="width:955px; background-color:#efeff7;"><p class="p_TiporNote" style="border-top: none; border-right: none; border-left: none;"><span class="f_TiporNote">Note:</span></p>
</td>
</tr>
<tr style="text-align:left;">
<td width="955" bgcolor="#f7f7ff" style="width:955px; background-color:#f7f7ff;"><p class="p_TiporNoteText"><span class="f_TiporNoteText">Sparx Systems strongly urge you not to manipulate version controlled package files outside of Enterprise Architect. It is possible to leave the package files in a state that Enterprise Architect cannot recognize.</span></p>
</td>
</tr>
</table>
</div>




            </div>
          </div>
        </div>



</div>


</body>
</html>
